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These manual pages cover the commands and utihty programs 
provided as part of the Tape Backup software. You can add these 
pages to your AT&T UNIX PC UNIX System V User's Manual, or 
if you do not have this document, keep them with your Tape 
Backup User's Guide. 
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NAME 

dbuf - double buffered I/O to floppy tape 

SYNOPSIS 

dbuf — o [ TbufsizeOoffset ] > device 

dbuf -i [ TbufsizeOoffsetSnumblocks ] device 

DESCRIPTION 

The dbuf program provides double buffered input/output with the 
floppy tape to improve operating efficiency. While one buffer is 
being filled, the other is being processed. Dbuf is normally used in 
conjunction with tapecpio{l). 

The parameter bufstze is the size in kilobytes (1KB = 1024B) to 
use for the double buffering. The offset parameter is the number 
of the first block to begin the data transfer. Numblocks is the 
number of blocks to be read from the device. The parameter dev- 
ice should be /dev/rft3. 

The dbuf program can be called with the -i option to read from 
the floppy tape, or the -o option to write to the tape. The fol- 
lowing options can be specified: 

i Read input from the floppy tape and send it to the stan- 

dard output. The output is usually piped into a program 
such as tapecp%o[\). 

o Read input from the standard input and write output to 

the standard output. The input is usually piped to dbuf 
from another program, such as tapecpio{\), and the out- 
put should be redirected to the device /dev/rft3. 

O Set the logical file position of where the transfer is to 

begin. The O is followed by the offset in blocks. For 
example, 

tapecpio ~oc | dbuf -o0128 > /dev/rft3 

will begin the output at block number 128 on the floppy 
tape. 

T Provide a specific buffer size for the tapecpio operation. 

The size of the buffer, in kilobytes, follows the T. For 
example, 

dbuf -iTl24 /dev/rft3 | tapecpio -ict 

will use two 124KB buffers while it reads the data from 
the tape and pipes it to tapecpio. 

S Specify the number of blocks to read from the tape. This 

option is used only with the — i option and provides a 
means by which to prevent dbuf from reading more data 
than is requested for the read operation. The number of 
blocks to read follows the S. For example, 

dbuf -iS242 /dev/rft3 | tapecpio -icd 

will read 242 blocks from the floppy tape and then stop. 
The data is piped to tapecpio using double buffering. 



SEE ALSO 

tapecpio (l). 



NAME 

execStrip - strip quotes in shell variables from parameter lines 

SYNOPSIS 

execStrip commandlist 

DESCRIPTION 

This program circumvents the shell's failure to strip quotes from a 
parameter line when they are contained in a shell variable. 
Exec strip strips the first and last characters off each parameter in 
the commandlist when the first character is a quote. If the first 
character of a parameter is not a quote, then the parameter is left 
intact. After stripping, all of the parameters are shifted back one 
position in the list, then the first parameter in the list is exceed 
using the call 

execvp (argv[0], argv) 

EXAMPLES 

The following input to execStrip: 

execStrip tapecpio -ic"B" "file/*'' file 'pat*' < $DEVICE 
becomes the following command: 

tapecpio -ic"B" file/* file pat* < $DEVICE 

SEE ALSO 

sh(l). 



1- 



NAME 

tapecpio - copy file archives to and from tape 

SYNOPSIS 

tapecpio -o [ TsizeOoffset ] < filelist > device 
tapecpio -i [ xRTsizeOoffset ] [ filename . . . ] < device 

DESCRIPTION 

The program tapecpio is an extension of the UNIX cpio{l) utility 
to handle the specific requirements of the Tape Backup subsystem. 

In the above synopsis, device is usually /dev/rft3, if the floppy 
tape drive is to be used. Filelist is a file containing the list of files 
to be backed up, and the filenames are the individual path names 
(regular expressions permitted) to be restored. 

Tapecpio can be called with any of the regular cpio{l) options, 
described in detail under cpio{l). In addition the following 
options are available: 

X Halt the tapecpio operation as soon as the first filename in 

the pattern list is restored (otherwise the entire cpio set is 
read). This option is used only with the -i option. 

R Allow files and directories with absolute path names to be 

redirected on input to the current working directory (see 
pwd{l)) by removing the leading / from the path name. 
This option is used only with the -i option. 

O Set the logical file position of where the transfer is to 

begin. The O is followed by an offset in blocks. For 
example, 

tapecpio -oc0128 > /dev/rft3 

will begin the output at block number 128. 

T Provides a specific buffer size for the cpio operation. The 

size of the buffer, in kilobytes (1KB = 1024B), follows the 
T. For example, 

tapecpio -ictTl24 < /dev/rft3 

will use a 124KB buffer while it reads the filenames from 
the cpio set. 

SEE ALSO 

cpio(l), pwd(l), cpio(4). 



NAME 

TdsplSSs - retrieve tape backup set information and display in a 
-menu 

SYNPOSIS 

TdsplSSs 

DESCRIPTION 

This program reads the current backup set information from the 
file /tmp/tape.vtoc and displays each backup set record on the 
screen in a menu. The file /tmp/tape.vtoc must be created 
using a Tgetname -v command before calling TdsplSSs. 

After the user selects the backup set(s) to show or restore, the 
offset of each selected backup set is written to the file 
/tmp/ss.osets. The command TgetOffsets can then be used to 
read the offsets from this file. 

If the user presses the EXIT or CANCL key, TdsplSSs exits with 
error code 1. 

FILES 

/tmp/tape.vtoc 
/tmp/ss.osets 

SEE ALSO 

Tgetname(l), TgetOffsets(l). 
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NAME 

TgetFtype - determine file type of a path name in a backup set 

SYNOPSIS 

TgetFtype filename 

DESCRIPTION 

This program reads a list of backup set files from the standard 
input. The list must be in ss.filelist format (see TmakessList{l)). 
The filename is checked against the backup set list to determine 
its file type. If it is not found, error code 2 is returned. Other- 
wise, a pattern is printed on the standard output which will allow 
the file and all subfiles to be restored by cpio{l): 

" ^NAME '" if a regular expression 

" 'NAME/* ' NAME" if a directory 

"NAME" otherwise 

To use this program, the output should be redirected to a shell 
variable and passed on to cpio : 

FTYPE=' TgetFtype main.c' 
cpio -ic $FTYPE < /dev/rft3 



FILES 



ss.filelist 



SEE ALSO 

cpio(l), TmakessList(l). 
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NAME 

Tgetname - read, write tape volume table of contents 

SYNOPSIS 

Tgetname [ -v | -r | -b | -t | +1 | -1 | -3 ] 
Tgetname -w backup^type tpname buname bucmt offset 
nblocks nfiles 

DESCRIPTION 

This program provides a means of accessing the volume table of 
contents (VTOC) and the backup set block on the floppy tape. 
The program provides three groups of functions: input, output 
and locking. 

For input, Tgetname prints the name of the current tape and the 
offset to the next free block. If the offset printed is -1, then the 
tape is assumed to be full. The input options are: 

-V Read the VTOC, backup set block, and cpio set block 
from tape, and write them to disk in the file 
/tmp/tape.vtoc. 

-r Read the VTOC and backup set blocks from the file 

created by the -v option, and return the offset to the 
next free space. 

-b This option performs the work of the — v and — r options 

in addition to checking for overwrite protection. For 
example, Tgetname -b might print 'My Tape' '1048' 
indicating that MyTape is the name of the floppy tape, 
1048 is the first free block number, and the tape is not 
write protected. 

-t Wait for up to 3 mmutes for the tape to retension. 

Display a message while tape is retensioning. Exit after 
open. 

For output, Tgetname reads and updates the file created by the 
~v option, adding the appropriate backup set information to the 
file. The output options are: 

-3 Overwrite all valid data in the backup set block with a 

"bogus" block. This is used to create a tape in 3B2 for- 
mat (not in "UNIX PC" format). 

-w Use the parameters provided to create a backup set entry. 
This option is used to create a tape in UNIX PC format. 
The parameters are: 

backuptype Must be one of the following backup types: 

Complete Backup 
Partial Backup 
Backup User 
Backup Folders 
Backup Files 
Backup by Names 
Backup Broken 
BAD BACKUP 



FILES 



"Backup Broken" indicates that the backup 
set continues onto the next tape; "BAD 
BACKUP" is used to delete an entry, and 
all that may follow it, from the backup set 
block. 

tpname The new name for the tape. 

buname The name given to this backup set. 

bucmnt The comment for the backup set, which 

must be less than 24 characters. 

offset The offset in blocks to the first block of the 

backup set. 

nblocks The size in blocks of the backup set. This 

number should be the same as that returned 
by cpio{l), or -1 to indicate end of data. 

nfiles The number of files in the backup set. 

The locking functions lock the floppy tape drive (permanently) 
and unlock it afterwards. The options are: 

+1 Lock the tape drive. 

-1 Unlock the tape drive. 

/tmp/tape.vtoc 



SEE ALSO 

tapecpio(l), Tgetovwrit(l). 
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NAME 

TgetOffsets - get offsets to and sizes of tape backup sets 

SYNOPSIS 

TgetOffsets [ -o | -s ] 

DESCRIPTION 

This program reads the file /tmp/ss.osets, created by 
TdsplSSs{l), to determine the sizes and offsets to the backup sets 
on the current tape and writes this information to the standard 
output. 

Each offset is followed by the size of the backup set in the file 
/tmp/ss.osets using the following format: 

OFFSET-.SIZE 

The offsets are printed enclosed in single quotes. Following the 
output, a pair of single quotes is printed. This is done to allow 
detection of empty lists. 

TgetOffsets is called with one of the following two options: 

-o Print the offset to each backup set in quotes, as follows: 

'OFFSETr ^0FFSET2' '' 

-s Print the offset to, and the size of, each backup set, as fol- 

lows: 



'OFFSETr 'SIZEr '0FFSET2^ 'SIZE2' '' 



FILES 

/tmp/ss.osets 

SEE ALSO 

TdsplSSs (1). 
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NAME 

Tgetovwrit - determine overwrite and type for a tape backup 
operation 

SYNOPSIS 

Tgetovwrit [ -b | -f ] 

DESCRIPTION 

This program determines whether the current tape "will be 
overwritten for the given operation. It also determines the type of 
backup performed by looking for the file name ss.filelist at the 
start of the backup set. If this file is found, the backup type is 
'^UNIXFC". Otherwise, the type is "3B2". 

Before Tgetovwrit -b can be used, a Tgetname -v or -6 com- 
mand must be used to read the volume table of contents block 
from the tape to the file /tmp/tape.vtoc (see Tgetname {!)). 

Tgetovwrit is called with the one of the following options: 

-b This option reads the first block of the cpio set to look for 
the cpio magic header to determine if the tape will be 
overwritten. If the header is found, then the ss.filelist 
entry is examined to determine the tape type. 

-f This option is used to determine if the tape is formatted. 

The first block of the cpio set is read to look for the cpio 
magic header to determine if the tape will be overwritten. 
If there is an error reading from the tape then the tape is 
assumed to be empty. 



FILES 



/tmp/tape.vtoc 
ss.filehst 



SEE ALSO 

tapecpio(l), Tgetname(l). 



1- 



NAME 

TmakeLmenu - create menu of files for tape backup or restore 

SYNOPSIS 

TmakeLmenu —b [ — d | — f ] 
TmakeLmienu -r [ -d | ~f ] 
TmakeLmenu -s [ -a | -3 ] 

DESCRIPTION 

This utility reads a list of file names from the standard input and 
creates a menu description file to display them. The menu is 
placed on the standard output and should be redirected to a menu 
file; the menu file is passed to shform{l), 

TmakeLmenu is called with two switches. The first indicates the 
type of menu desired. The second switch indicates the type of 
contents to be displayed in the menu. 

The first switch can be one of the following: 

-b Used for backup operations. The menu created is mul- 
tiselectable. The title indicates that the contents come 
from the Filecabinet. 

-r Used for restore operations. The menu created is mui- 

tiselectable. The title indicates that the contents come 
from the tape. 

-s Used for showing tape contents. The menu created is not 

multiselectable. The title is always "Tape Contents." 

The second switch is one of the following: 

-d The contents are folders. The input is in ss.filelist for- 

mat (see TmakessList{l)). (Used only with -b and -r.) 

-f The contents are files. The input is in ss.filelist format 

(used only with -b and -r). 

-a The contents may be both files and folders. The input is 

in ss.filelist format (used with -s only). 

-3 The contents come from a cpio -it output (used with -s 

only). 

EXAMPLE 

The following: 

cpio -it < /dev/rft3 | TmakeLmenu -s -3 > menufile 

creates a menu file containing the list of files and folders in a tape 
backup set. 

FILES 

ss.filelist 

SEE ALSO 

cpio(l), shform(l), TmakessList(l). 
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NAME 

TmakessList, TprintSS - generate, print file list for tape backup 

SYNOPSIS 

TmakessList offset 
TmakessList type 
TprintSS type tapename 

DESCRIPTION 

TmakessList generates a file list in ss.filelist format for use by 
TgetFtype{l). TprintSS prints the filelist on the standard output. 
The list thus generated is used in creating tape backup sets 

TmakessList reads a list of files from the standard input and 
determines whether each is a directory. For each directory, the 
character d is printed to the standard output followed by the file 
name. For each file that is not a directory, the character - is 
printed to the standard output followed by the filename. The size 
of each file is accumulated, then added to offset (in blocks) and 
used to calculate the number of tapes required for the backup. 
This number is returned through the exit status. 

TmakessList is called with one mandatory parameter, the offset to 
the start of the next backup set. This command can be used to 
generate an ss.filelist file from a epic -itv (verbose) listing by 
specifying for offset and a second parameter, type, such as 3B2 
(see TgetOvwrit{l)). 

TprintSS prints the contents of an ss.filelist file to the standard 
output, which can then be redirected to the appropriate printer. 
This program is called with two parameters. The first parameter, 
type, is the floppy tape backup type and can be UNIX PC or 
3B2. The second argument, tapename, is the name of the tape. 
For example: 

TprintSS "UNIX PC" "MyTape" < ss.filelist | Ip 

EXAMPLE 

To generate a backup set filelist: 

Is I TmakessList 1024 > ss.filelist 

This generates a file list of files in the current working directory 
(see pwd{l)) and exits with the number of floppy tapes required to 
perform this backup starting at block 1024 on the tape. 



FILES 



ss.filelist 



SEE ALSO 

cpio(l), TgetFtype(l). 
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